home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / g_doom / deep870s.zip / DEACC.TXT < prev    next >
Text File  |  1996-03-08  |  2KB  |  72 lines
  1. DeePDeac derived from DEACC.EXE v1.10.1 by Luc Cluitmans
  2.  
  3. This is the documentation for DEEPACC as executed by DeeP. 
  4.  
  5. *About Decompilation*
  6.  
  7. DEACC tries to decompile hexen scripts into ACS files.
  8.  
  9. Some info that was in the original ACS source for the script is
  10. not available in the compiled form of the script: DEACC will not
  11. be able to recover this information. DEACC is not able to:
  12. - recover the original variable names
  13. - recover any comments
  14. - recover the exact source for constructs that can be written
  15.   in several ways. DEACC tries to generate 'break' and 
  16.   'continue' statements only if no other construct can be found.
  17.  
  18. I tested DEACC on all scripts of the original Hexen.Wad. The output
  19. it produces for each original hexen script was compilable by ACC.
  20. When ACC compiled the ACS files produced by DEACC, the resulting
  21. behavior lump was exactly equal to the original for all maps (the bug
  22. for MAP22 and MAP39 in deacc 1.0 has been fixed)!
  23.  
  24.  
  25. *Frequently Asked Question*
  26. Q: "Hey, I get an error when I try to decompile the behavior of
  27.     MAP07. What is going on?"
  28. A: There is no MAP07 in the original hexen wad! The other missing
  29.    numbers are: MAP14, MAP15, MAP16, MAP17, MAP18, MAP19, MAP20,
  30.    MAP29, and any MAPxy with xy>41.
  31.  
  32.  
  33. *Bugs*
  34.  
  35. None. Well, I know of some constructs that would not decompile
  36. correctly, but you probably will not encounter them :-).
  37.  
  38.  
  39. *Acknowledgements*
  40.  
  41. Thanks to:
  42. - Raven Software and id Software for creating Hexen
  43. - Ben Morris for the Hexen Specs
  44. - John B. Williston for getting me on the track of hexen decompilation
  45.  
  46.  
  47. *History*
  48.  
  49. 21 November 1995
  50.     Released version 1.0 of DEACC
  51.  
  52. 05 December 1995
  53.     Version 1.1:
  54.     - fixed the string variable problem (DEACC 1.0 did not correctly
  55.       decompile scripts containing string variables, like MAP22 and
  56.       MAP39 in the original hexen wad).
  57.     - fixed a few small and barely noticable bugs. 
  58.  
  59. 01 March 1996
  60.     Version 1.10.1
  61.     - SBS converted to DeeP DPMI mode.
  62.     - slight revison in commented output.
  63.  
  64. *Feedback*
  65.  
  66. If you have comments or bug reports: send me  a message via email:
  67.    L.J.M.Cluitmans@ele.tue.nl
  68.  
  69.  
  70.     Luc.
  71.  
  72.